Точечная статистика (Spatial Analyst)

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

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

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

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

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

  • Существует несколько форм окрестности и типов статистики для выбора. Варианты доступной статистики зависят от типа указанного поля.

  • Типы статистики, являющиеся доступными для выбора для целочисленных полей: большинство, максимум, среднее, медиана, минимум, меньшинство, диапазон, стандартное (среднеквадратическое) отклонение, сумма и разнообразие. Допустимая статистика для полей float (с плавающей точкой): максимум, среднее, минимум, диапазон, среднеквадратическое отклонение и сумма. Меньшинство, большинство и разнообразие недоступны.

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

    Если тип поля float, выходной растр будет типа float для всех доступных типов статистики.

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

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

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

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

  • См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.

Параметры

ПодписьОписаниеТип данных
Входные точечные объекты

Входные точки, используемые в операции окрестности.

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

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

Feature Layer
Поле

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

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

Field
Размер выходной ячейки
(Дополнительный)

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

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

Analysis Cell Size
Окрестность
(Дополнительный)

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

Когда выбран тип окрестности, можно задать другие параметры, чтобы полностью определить форму, размер и единицы измерения. Окрестность по умолчанию – квадрат со стороной три ячейки.

Доступны следующие формы типов окрестностей:

  • Кольцо, Внутренний радиус, Внешний радиус, Тип единиц

    Окрестность в форме кольца, определяемая внутренним радиусом и внешним радиусом. Кольцо по умолчанию – внутренний радиус одной ячейки и внешний радиус трех ячеек.

  • Круг, Радиус, Тип единиц

    Круговая окрестность с заданным радиусом. Значение радиуса по умолчанию равно трем ячейкам.

  • Прямоугольник, Высота, Ширина, Тип единиц

    Прямоугольная окрестность, определенная высотой и шириной. Прямоугольная окрестность по умолчанию – квадрат со стороной три ячейки.

  • Клин, Радиус, Начальный угол, Конечный угол, Тип единиц

    Окрестность в форме клина определяется радиусом, начальным углом и конечным углом. Клин строится в направлении против часовой стрелки от начального угла до конечного угла. Углы задаются в градусах, величина равная 0 или 360 представляет восток. Могут использоваться отрицательные значения углов. Клин по умолчанию имеет значение от 0 до 90 градусов, с радиусом, равным трем ячейкам.

Единицы расстояния для параметров могут быть заданы как единицы Ячейка или единицы Карта. По умолчанию используются единицы ячейки.

Neighborhood
Тип статистики
(Дополнительный)

Указывает тип вычисляемой статистики.

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

Типом статистики по умолчанию является Среднее.

Доступные варианты типа статистики определяются числовым типом указанного поля. Если значения поля целочисленные, доступны все типы статистики. Если поле имеет тип float, то будет доступны только статистика максимума, среднего, минимума, диапазона, стандартного отклонения и суммы.

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

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

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

Выходной растр точечной статистики.

Raster

PointStatistics(in_point_features, field, {cell_size}, {neighborhood}, {statistics_type})
ИмяОписаниеТип данных
in_point_features

Входные точки, используемые в операции окрестности.

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

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

Feature Layer
field

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

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

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

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

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

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

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

Когда выбран тип окрестности, можно задать другие параметры, чтобы полностью определить форму, размер и единицы измерения. Окрестность по умолчанию – квадрат со стороной три ячейки.

Форма окрестностей вокруг каждой входной точки определяется классом Neighborhood. Доступные типы окрестностей NbrAnnulus, NbrCircle, NbrRectangle, и NbrWedge.

Доступны следующие формы типов окрестностей:

  • NbrAnnulus({innerRadius}, {outerRadius}, {units})

    Окрестность в форме кольца, определяемая внутренним радиусом и внешним радиусом. Кольцо по умолчанию – внутренний радиус одной ячейки и внешний радиус трех ячеек.

  • NbrCircle({radius}, {units}

    Круговая окрестность с заданным радиусом. Значение радиуса по умолчанию равно трем ячейкам.

  • NbrRectangle({width}, {height}, {units})

    Прямоугольная окрестность, определенная высотой и шириной. Прямоугольная окрестность по умолчанию – квадрат со стороной три ячейки.

  • NbrWedge({radius}, {startAngle}, {endAngle}, {units})

    Окрестность в форме клина определяется радиусом, начальным углом и конечным углом. Клин строится в направлении против часовой стрелки от начального угла до конечного угла. Углы задаются в градусах, величина равная 0 или 360 представляет восток. Могут использоваться отрицательные значения углов. Клин по умолчанию имеет значение от 0 до 90 градусов, с радиусом, равным трем ячейкам.

Единицы расстояния для параметров могут быть заданы как единицы CELL или единицы MAP. По умолчанию используются единицы ячейки.

По умолчанию тип окрестности NbrRectangle со стороной, равной трем ячейкам.

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

Указывает тип вычисляемой статистики.

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

  • MEANБудет рассчитано среднее значение для значений полей в каждой окрестности.
  • MAJORITYОпределяется наиболее часто возникающее значение поля в каждой окрестности. В случае наличия связи, используется минимальное значение.
  • MAXIMUMОпределяется наибольшее значение поля в каждой окрестности.
  • MEDIANОпределяется среднее значение поля в каждой окрестности. В том случае, если в окрестности находится четное количество точек, результатом будет меньшее из двух средних значений.
  • MINIMUMОпределяется наименьшее значение поля в каждой окрестности.
  • MINORITYОпределяется наиболее редко возникающее значение поля в каждой окрестности. В случае наличия связи, используется минимальное значение.
  • RANGEВычисляется диапазон (разница между наибольшим и наименьшим) значений поля в окрестности.
  • STDВычисляется среднеквадратическое отклонение значений ячеек в окрестности.
  • SUMРассчитывается сумма значений полей в каждой окрестности.
  • VARIETYВычисляется число уникальных значений поля в каждой окрестности.

Типом статистики по умолчанию является MEAN.

Доступные варианты типа статистики определяются числовым типом указанного поля. Если значения поля целочисленные, доступны все типы статистики. Если поле имеет тип float, то будет доступны только статистика максимума, среднего, минимума, диапазона, стандартного отклонения и суммы.

String

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

ИмяОписаниеТип данных
out_raster

Выходной растр точечной статистики.

Raster

Пример кода

PointStatistics, пример 1 (окно Python)

В этом примере определяется статистика (сумма) на точечных объектах входного шейп-файла, которые попадают круглую окрестность вокруг каждой ячейки выходного растра.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outPointStats = PointStatistics("ca_ozone_pts.shp", "OZONE", 500, 
                                NbrCircle(10000, "MAP"), "SUM")
outPointStats.save("C:/sapyexamples/output/pointstatsout")
PointStatistics, пример 2 (автономный скрипт)

В этом примере определяется статистика (среднее) на точечных объектах входного шейп-файла, которые попадают круглую окрестность вокруг каждой ячейки выходного растра.

# Name: PointStatistics_Ex_02.py
# Description: Calculates a statistic on points over a specified 
#    neighborhood outputting a raster.
# 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
inPointFeatures = "ca_ozone_pts.shp"
field = "OZONE"
cellSize = 500
neighborhood = NbrCircle(6000, "MAP")

# Execute PointStatistics
outPointStatistics = PointStatistics(inPointFeatures, field, cellSize,
                                     neighborhood, "MEAN")

# Save the output 
outPointStatistics.save("C:/sapyexamples/output/pointstatout")

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

  • Basic: Обязательно Spatial Analyst
  • Standard: Обязательно Spatial Analyst
  • Advanced: Обязательно Spatial Analyst

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