Линейная статистика (Инструменты Spatial Analyst)

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

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

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

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

Несколько типов статистики для выбора. Выбор доступной статистики зависит от типа указанного поля.
Для целочисленных полей доступный выбор Типов статистики: большинство, максимум, среднее, медиана, минимум, меньшинство, диапазон, разнообразие и длина. Для полей с плавающей точкой доступная статистика: максимум, среднее, минимум, диапазон и длина. Большинство, меньшинство и разнообразие не доступны.
Если тип поля целое, выходной растр будет с целочисленными значениями для следующих типов статистики: большинство, максимум, медиана, минимум, меньшинство, диапазон и разнообразие. Выходной растр будет со значениями с плавающей точкой для типа статистики среднее и длина.

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

Если размер ячейки задан с использованием набора растровых данных, параметр покажет путь к набору растровых данных вместо значения размера ячейки. Размер ячейки этого набора растровых данных будет использоваться непосредственно в анализе при условии, что пространственная привязка набора данных совпадает с выходной пространственной привязкой. Если пространственная привязка набора данных отличается от выходной пространственной привязки, она будет спроецирована на основе значения Метод проецирования размера ячейки.
См. раздел Параметры среды анализа и Spatial Analyst для получения дополнительной информации о настройках среды геообработки, применяемые к данному инструменту.

Подпись	Объяснение	Тип данных
Входные линейные объекты	Входные линии для использования в операции окрестности. Для каждой выходной ячейки вычисляется статистика для всех частей входных объектов линий, которые попадают в окружность окрестности вокруг ячейки. Размер окружности окрестности определяется радиусом поиска.	Feature Layer
Поле	Поля, для которого будет вычислена указанная статистика. Оно может быть любым числовым полем входных объектов. Когда Тип статистики установлен на Длина, для параметра Поле можно задать NONE. Если входные объекты содержат значения 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`. Доступные варианты типа статистики определяются числовым типом указанного поля. Если поле целочисленное, доступный выбор статистики будет таким: большинство, максимум, среднее, медиана, минимум, меньшинство, диапазон, разнообразие и длина. Для полей с плавающей точкой доступная статистика только: максимум, среднее, минимум, диапазон и длина. `MEAN`–Будет вычислено среднее значение поля в каждой окрестности, взвешенное по длине. Формула вычисления: Среднее = (сумма (длина * значение поля)) / (сумма_длин). Используется только та часть линии, которая попадает в окрестность. `MAJORITY`–Будет найдено значение, соответствующее наибольшей длине линий в окрестности. `MAXIMUM`–Будет найдено наибольшее значение в окрестности. `MEDIAN`–Будет вычислено значение медианы, взвешенное по длине. Концептуально, все сегменты линий в окрестности отсортированы по значению и выстроены в одну линию по принципу конечная точка - конечная точка. Значение сегмента в срединной точке прямой линии равно медиане. `MINIMUM`–Будет найдено наименьшее значение в каждой окрестности. `MINORITY`–Будет найдено значение, соответствующее наименьшей длине линии в окрестности. `RANGE`–Будет вычислен диапазон значений (максимум-минимум). `VARIETY`–Будет вычислено число уникальных значений. `LENGTH`–Будет вычислена общая длина линии в окрестности. Если значение в поле не 1, длина умножается на значение, указанное для элемента, перед добавлением. Эта опция может использоваться в случае, если для параметра поля задано Нет.	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

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

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

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

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

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

Basic: Требуется Spatial Analyst
Standard: Требуется Spatial Analyst
Advanced: Требуется Spatial Analyst

Линейная статистика (Инструменты Spatial Analyst)

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

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

Параметры

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

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

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

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