Линейная статистика (Spatial Analyst)—ArcGIS Pro

Доступно с лицензией Spatial Analyst.

Краткая информация

Вычисляет статистику по атрибутам линий, расположенных в круговой области соседства вокруг каждой выходной ячейки.

Более подробно о том, как работает инструмент Линейная статистика

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

Существует несколько типов статистики для выбора. Варианты доступной статистики зависят от типа указанного поля.
Типы статистики, доступные для выбора для целочисленных полей: большинство, максимум, среднее, медиана, минимум, меньшинство, диапазон, разнообразие и длина. Допустимая статистика для полей с плавающей точкой: максимум, среднее, минимум, диапазон, и длина. Меньшинство, большинство и разнообразие недоступны.
Если тип поля целочисленный, выходной растр будет целочисленным для следующей статистики: большинство, максимум, медиана, минимум, меньшинство, диапазон и разнообразие. Выходной растр будет типа float для статистики среднее и длина.
Если тип поля float, выходной растр будет типа float для всех доступных типов статистики.
Для типов статистики большинство, среднее, медиана, меньшинство и длина учитывается только часть линии, попадающая в окрестность. Для типов статистики большинство, минимум, диапазон и разнообразие может использоваться как часть, так и целая линия.
Для статистики типа большинство, среднее, медиана и меньшинство вычисляется вес пропорционально длине линий. Например, если одна линия в два раза длиннее другой, считается, что значение встречается в два раза чаще.
Если в окрестности ячейки растра нет линий, при использовании типа статистики разнообразие и длина ячейке присваивается нулевое значение. При использовании других типов статистики, ячейке присваивается значение NoData.
Выходной размер ячейки можно задать как числовым значением, так и получить из существующего набора растровых данных. Если размер ячейки не был явно задан как значение параметра, он извлекается из параметра среды Размер ячейки, если такой задан. Если же и в параметр среды значение размера ячейки не указано, но настроен параметр Растр привязки, то будет использоваться значение величины его ячейки. Если же ни один из параметров не задан, то размер ячейки будет вычислен как наименьшее значение длины либо ширины экстента растра, поделенное на 250, при этом экстент берется из параметра среды Выходная система координат.
Если размер ячейки указан в виде числа, то инструмент будет использовать это значение для выходного растра.
Если для определения размера ячейки указан другой растр, в параметре будет показан путь к набору растровых данных вместо значения размера ячейки. Размер ячейки этого растра будет использоваться непосредственно в анализе указанная пространственная привязка набора данных будет такой же, как и выходная система координат. Если же пространственная привязка набора данных отличается от выходной пространственной привязки, на будет перепроецирована на основе выбранного Метода проецирования размера ячейки.
См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.

Параметры

Подпись	Описание	Тип данных
Входные линейные объекты	Входные линии, используемые в операции окрестности. Для каждой выходной ячейки будет вычислена статистика для всех фрагментов входных полилинейных объектов, которые попадают в окрестность в форме окружности вокруг ячейки. Размер окрестности в форме окружности определяется радиусом поиска.	Feature Layer
Поле	Поле, для которого будут вычислена указанная статистика. Это может быть любое числовое поле входных линейных объектов. Если Тип статистики установлен на Длина, для параметра Поле можно задать значение Нет. Если входные объекты содержат значения z, оно может быть представлено полем Shape.	Field
Размер выходной ячейки (Дополнительный)	Размер ячейки выходного растра, который будет создан. Этот параметр можно задать как числовым значением, так и получить из существующего набора растровых данных. Если размер ячейки не был в явном виде задан как значение параметра, будет использоваться значение размера ячейки, указанное в параметрах среды геообработки, если же и оно не указано, будут использоваться дополнительные правила вычисления размера ячейки на основе входных данных. Более подробно см. раздел об использовании.	Analysis Cell Size
Радиус поиска (Дополнительный)	Радиус поиска, который будет использован для вычисления статистики, выраженный в единицах карты. Радиус по умолчанию равен пятикратному размеру ячейки.	Double
Тип статистики (Дополнительный)	Указывает тип вычисляемой статистики. Статистика вычисляется для значений заданного поля для всех линий в окрестности. Типом статистики по умолчанию является Среднее. Доступные варианты типа статистики определяются числовым типом указанного поля. Когда поле является целочисленным, можно выбрать следующие доступные типы статистики: большинство, максимум, среднее, медиана, минимум, меньшинство, диапазон, разнообразие и длина. Если поле с плавающей точкой, доступны только следующие типы статистики - среднее, максимум, минимум, диапазон и длина. Среднее—Среднее значение поля в каждой окрестности, взвешенной по длине, которое будет вычислено.Форма расчета: Среднее = (сумма (длина * значение поля)) / (сумма длин) Используется только часть линии, попадающая в пределы окрестности. Большинство—Будет определено значение, соответствующее максимальной длине линии в окрестности. Максимум—Определяется наибольшее значение в окрестности. Медиана—Вычисляется медианное значение, взвешенное по длине.Концептуально, все сегменты линий в окрестности отсортированы по значению и выстроены в одну линию по принципу конечная точка - конечная точка. Значение сегмента в срединной точке прямой линии равно медиане. Минимум—Определяется наименьшее значение в каждой окрестности. Меньшинство—Будет определено значение, соответствующее минимальной длине линии в окрестности. Диапазон—Будет вычислен диапазон значений (максимум-минимум). Разнообразие—Будет вычислено количество уникальных значений. Длина—Будет вычислена суммарная длина линии в окрестности. Если значение в поле не равно 1, длина умножается на это значение, перед добавлением к общей сумме. Эта опция может использоваться в случае, если у параметра Поля значение Нет.	String

Возвращаемое значение

Подпись	Описание	Тип данных
Выходной растр	Выходной растр линейной статистики.	Raster

LineStatistics(in_polyline_features, field, {cell_size}, {search_radius}, {statistics_type})

Имя	Описание	Тип данных
in_polyline_features	Входные линии, используемые в операции окрестности. Для каждой выходной ячейки будет вычислена статистика для всех фрагментов входных полилинейных объектов, которые попадают в окрестность в форме окружности вокруг ячейки. Размер окрестности в форме окружности определяется радиусом поиска.	Feature Layer
field	Поле, для которого будут вычислена указанная статистика. Это может быть любое числовое поле входных линейных объектов. Если statistics_type установлен на Length, для параметра field можно задать значение NONE. Если входные объекты содержат значения z, оно может быть представлено полем Shape.	Field
cell_size (Дополнительный)	Размер ячейки выходного растра, который будет создан. Этот параметр можно задать как числовым значением, так и получить из существующего набора растровых данных. Если размер ячейки не был в явном виде задан как значение параметра, будет использоваться значение размера ячейки, указанное в параметрах среды геообработки, если же и оно не указано, будут использоваться дополнительные правила вычисления размера ячейки на основе входных данных. Более подробно см. раздел об использовании.	Analysis Cell Size
search_radius (Дополнительный)	Радиус поиска, который будет использован для вычисления статистики, выраженный в единицах карты. Радиус по умолчанию равен пятикратному размеру ячейки.	Double
statistics_type (Дополнительный)	Указывает тип вычисляемой статистики. Статистика вычисляется для значений заданного поля для всех линий в окрестности. MEAN—Среднее значение поля в каждой окрестности, взвешенной по длине, которое будет вычислено.Форма расчета: Среднее = (сумма (длина * значение поля)) / (сумма длин) Используется только часть линии, попадающая в пределы окрестности. MAJORITY—Будет определено значение, соответствующее максимальной длине линии в окрестности. MAXIMUM—Определяется наибольшее значение в окрестности. MEDIAN—Вычисляется медианное значение, взвешенное по длине.Концептуально, все сегменты линий в окрестности отсортированы по значению и выстроены в одну линию по принципу конечная точка - конечная точка. Значение сегмента в срединной точке прямой линии равно медиане. MINIMUM—Определяется наименьшее значение в каждой окрестности. MINORITY—Будет определено значение, соответствующее минимальной длине линии в окрестности. RANGE—Будет вычислен диапазон значений (максимум-минимум). VARIETY—Будет вычислено количество уникальных значений. LENGTH—Будет вычислена суммарная длина линии в окрестности. Если значение в поле не равно 1, длина умножается на это значение, перед добавлением к общей сумме. Эта опция может использоваться в случае, если у параметра Поля значение Нет. Типом статистики по умолчанию является MEAN. Доступные варианты типа статистики определяются числовым типом указанного поля. Когда поле является целочисленным, можно выбрать следующие доступные типы статистики: большинство, максимум, среднее, медиана, минимум, меньшинство, диапазон, разнообразие и длина. Если поле с плавающей точкой, доступны только следующие типы статистики - среднее, максимум, минимум, диапазон и длина.	String

Возвращаемое значение

Имя	Описание	Тип данных
out_raster	Выходной растр линейной статистики.	Raster

Пример кода

LineStatistics Пример 1 (окно Python)

В этом примере вычисляется средняя длина линейных сегментов на определенном радиусе каждой ячейки входного растра.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
lineStatOut = LineStatistics("streams", "LENGTH", 50, 500, "MEAN")
lineStatOut.save("C:/sapyexamples/output/linestatout")

LineStatistics, пример 2 (автономный скрипт)

# Name: LineStatistics_Ex_02.py
# Description: 
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inLines = "streams.shp"
field = "LENGTH"
cellSize = 50
searchRadius = 500

# Execute LineStatistics
lineStatOut = LineStatistics(inLines, field, cellSize, searchRadius,
                              "MEAN")

# Save the output 
lineStatOut.save("C:/sapyexamples/output/linestatisout")

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

Автоматическое подтверждение, Размер ячейки, Метод проецирования размера ячейки, Сжатие, Текущая рабочая область, Экстент, Географические преобразования, Выходное ключевое слово CONFIG, Выходная система координат, Временная рабочая область, Растр привязки, Размер листа

Краткая информация

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

Параметры

Возвращаемое значение

Возвращаемое значение

Пример кода

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

Особые случаи

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

Связанные разделы

В этом разделе