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

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

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

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

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

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

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

  • Если размер ячейки указан в виде числа, то инструмент будет использовать это значение для выходного растра.

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

  • Для типов статистики Большинство, Среднее, Медиана, Меньшинство и Длина учитывается только часть линии, попадающая в окрестность. Для других типов статистики не имеет значения, используется ли часть линии или линия целиком.

  • Если в окрестности ячейки растра нет линий, при использовании типа статистики Разнообразие и Длина ячейке присваивается нулевое значение. При использовании других типов статистики, ячейке присваивается значение NoData.

  • Статистика по типу Большинство, Среднее, Медиана и Меньшинство взвешивается пропорционально длине линий. Например, если одна линия в два раза длиннее другой, считается, что значение встречается в два раза чаще.

  • При использовании типа статистики Разнообразие значения на выходном растре всегда будут целочисленными. Для типов статистики Среднее и Длина значения на выходном растре всегда будут представлены числами с плавающей точкой. Для других типов статистики тип выходных данных совпадает с типом значений входного поля.

  • Для типов статистики Большинство, Максимум, Медиана, Минимум, Меньшинство и Диапазон, тип выходных данных растра будет совпадать с типом значений входного поля. Для типов статистики Среднее и Длина, выходной растр всегда будет представлен числами с плавающей точкой. Для типа статистики Разнообразие выходной растр всегда будет целочисленным.

  • См. раздел Среда анализа и 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

Поле, для которого будут вычислена указанная статистика. Оно может быть любым числовым полем входных объектов.

Если выбран тип статистики Length, для параметра field можно задать значение Нет.

Если входные объекты содержат значения z, оно может быть представлено полем Shape.

Field
cell_size
(Дополнительный)

Размер ячейки выходного растра, который будет создан.

Этот параметр можно задать как числовым значением, так и получить из существующего набора растровых данных. Если размер ячейки не был в явном виде задан как значение параметра, будет использоваться значение размера ячейки, указанное в параметрах среды геообработки, если же и оно не указано, будут использоваться дополнительные правила вычисления размера ячейки на основе входных данных. Более подробно см. раздел об использовании.

Analysis Cell Size
search_radius
(Дополнительный)

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

Радиус по умолчанию равен пятикратному размеру ячейки.

Double
statistics_type
(Дополнительный)

Задает вычисляемый тип статистики.

Статистика вычисляется для значений заданного поля для всех линий в окрестности.

  • 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

# Execute 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

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