Плотность точек (Spatial Analyst)

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

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

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

Иллюстрация

Иллюстрация работы инструмента Плотность точек
OutRas = PointDensity(InPts, None, 30)

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

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

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

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

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

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

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

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

  • Если масштабный коэффициент единиц измерения площади мал относительно расстояний между точками, то значения выходного растра могут быть маленькими. Чтобы получить более высокие значения, выберите коэффициент масштаба для единиц площади для более крупных единиц измерения (например, квадратные километры, а не квадратные метры).

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

Параметры

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

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

Feature Layer
Поле генеральной совокупности

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

Значения в поле генеральной совокупности могут быть целочисленными или с плавающей точкой.

Опции и поведение по умолчанию для поля перечислены ниже.

  • Используйте значение Нет, если не будет использовано какого-либо показателя или специального значения, и каждый объект будет подсчитан один раз.

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

  • В противном случае, полем по умолчанию будет POPULATION. Также могут применяться следующие условия:

    • Если отсутствует поле POPULATION, но присутствует поле POPULATIONabcd оно будет использовано по умолчанию. 'abcd' могут быть любыми допустимыми символами, например, POPULATION6, POPULATION1974 или POPULATIONROADTYPE.
    • Если нет поля POPULATION или поля POPULATIONabcd, но присутствует поле POP, по умолчанию будет использовано поле POP.
    • Если нет поля POPULATION, поля POPULATIONabcd или поля POP, но присутствует поле POPabcd, по умолчанию будет использовано поле POPabcd.
    • Если нет поля POPULATION, поля POPULATIONabcd, поля POP или поля POPabcd, по умолчанию будет использовано поле NONE.
Field
Размер выходной ячейки
(Дополнительный)

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

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

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

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

  • Кольцо - кольцевая окрестность (почник), определяемая внутренним и внешним радиусами.
  • Круг - круговая окрестность с заданным радиусом. По умолчанию, радиус - это наименьшее значение из ширины или высоты экстента входных точечных объектов в выходной пространственной привязке, деленное на 30.
  • Прямоугольник - прямоугольная окрестность, с заданной высотой и шириной.
  • Клин - окрестность в форме клина. Клин определяется радиусом, начальным углом и конечным углом. Клин строится в направлении против часовой стрелки от начального угла до конечного угла. Углы задаются в арифметических градусах (в направлении против часовой стрелки от положительного направления оси x). Можно использовать отрицательные значения углов.
  • Ячейка | Карта - определяет единицы измерения выбранной окрестности либо в ячейках, либо в единицах карты (на основе линейных единиц проекции выходной пространственной привязки).
Neighborhood
Единицы площади
(Дополнительный)

Указывает единицы площади, которые будут использоваться для выходных значений плотности.

По умолчанию единицы измерения определяются на основе линейных единиц выходной пространственной привязки. Можно изменить их на соответствующие единицы измерения, чтобы преобразовать выходные данные плотности. Значения для плотности линий преобразуют единицы измерения и длин, и площадей.

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

Если выходными единицами измерения являются иные, чем футы или метры, единицы, то выходными площадными единицами измерения плотности будут установлены Квадратные единицы карты. Таким образом единицы выходной плотности будут квадратом линейных единиц выходной пространственной привязки. Например, если выходными линейными единицами измерения являются сантиметры, то выходными площадными единицами измерения плотности будут Квадратные единицы карты, что приводит к результату в квадратных сантиметрах. Если выходными линейными единицами измерения являются километры, то выходными площадными единицами измерения плотности будут Квадратные единицы карты, что приводит к результату в квадратных километрах.

Доступными опциями и соответствующими им выходными единицами измерения плотности являются следующие:

  • Единицы площади картыБудет использоваться квадрат линейных единиц измерения для выходной пространственной привязки.
  • Квадратные милиБудут использоваться мили США.
  • Квадратные километрыБудут использоваться километры.
  • АкрыБудут использоваться Акры США.
  • ГектарыБудут использоваться гектары.
  • Квадратные ярдыБудут использоваться ярды США.
  • Квадратные футыБудут использоваться футы США.
  • Квадратные дюймыБудут использоваться дюймы США.
  • Квадратные метрыБудут использоваться метры.
  • Квадратные сантиметрыБудут использоваться сантиметры.
  • Квадратные миллиметрыБудут использоваться миллиметры.
String

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

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

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

Это всегда растр с плавающей точкой.

Raster

PointDensity(in_point_features, population_field, {cell_size}, {neighborhood}, {area_unit_scale_factor})
ИмяОписаниеТип данных
in_point_features

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

Feature Layer
population_field

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

Значения в поле генеральной совокупности могут быть целочисленными или с плавающей точкой.

Опции и поведение по умолчанию для поля перечислены ниже.

  • Используйте значение Нет, если не будет использовано какого-либо показателя или специального значения, и каждый объект будет подсчитан один раз.

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

  • В противном случае, полем по умолчанию будет POPULATION. Также могут применяться следующие условия:

    • Если отсутствует поле POPULATION, но присутствует поле POPULATIONabcd оно будет использовано по умолчанию. 'abcd' могут быть любыми допустимыми символами, например, POPULATION6, POPULATION1974 или POPULATIONROADTYPE.
    • Если нет поля POPULATION или поля POPULATIONabcd, но присутствует поле POP, по умолчанию будет использовано поле POP.
    • Если нет поля POPULATION, поля POPULATIONabcd или поля POP, но присутствует поле POPabcd, по умолчанию будет использовано поле POPabcd.
    • Если нет поля POPULATION, поля POPULATIONabcd, поля POP или поля POPabcd, по умолчанию будет использовано поле NONE.
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})

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

  • {units}

    Определяет единицы измерения либо как количество ячеек, либо как значение в единицах карты.

По умолчанию NbrCircle, где radius является значением меньшего из размеров ширины или высоты экстента выходных объектов на выходной пространственной привязке, деленное на 30.

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

Указывает единицы площади, которые будут использоваться для выходных значений плотности.

По умолчанию единицы измерения определяются на основе линейных единиц выходной пространственной привязки. Можно изменить их на соответствующие единицы измерения, чтобы преобразовать выходные данные плотности. Значения для плотности линий преобразуют единицы измерения и длин, и площадей.

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

Если выходными единицами измерения являются иные, чем футы или метры, единицы, то выходными площадными единицами измерения плотности будут установлены Квадратные единицы карты. Таким образом единицы выходной плотности будут квадратом линейных единиц выходной пространственной привязки. Например, если выходными линейными единицами измерения являются сантиметры, то выходными площадными единицами измерения плотности будут Квадратные единицы карты, что приводит к результату в квадратных сантиметрах. Если выходными линейными единицами измерения являются километры, то выходными площадными единицами измерения плотности будут Квадратные единицы карты, что приводит к результату в квадратных километрах.

Доступными опциями и соответствующими им выходными единицами измерения плотности являются следующие:

  • SQUARE_MAP_UNITSБудет использоваться квадрат линейных единиц измерения для выходной пространственной привязки.
  • SQUARE_MILESБудут использоваться мили США.
  • SQUARE_KILOMETERSБудут использоваться километры.
  • ACRESБудут использоваться Акры США.
  • HECTARESБудут использоваться гектары.
  • SQUARE_YARDSБудут использоваться ярды США.
  • SQUARE_FEETБудут использоваться футы США.
  • SQUARE_INCHESБудут использоваться дюймы США.
  • SQUARE_METERSБудут использоваться метры.
  • SQUARE_CENTIMETERSБудут использоваться сантиметры.
  • SQUARE_MILLIMETERSБудут использоваться миллиметры.
String

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

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

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

Это всегда растр с плавающей точкой.

Raster

Пример кода

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

В этом примере вычисляется растр плотности из точечного шейп-файла.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
pdensOut = PointDensity("rec_sites.shp", "NONE", 60, NbrCircle(2500, "MAP"))
pdensOut.save("C:/sapyexamples/output/pointdensity")
PointDensity, пример 2 (автономный скрипт)

В этом примере вычисляется растр плотности из точечного шейп-файла.

# Name: PointDensity_Ex_02.py
# Description: Calculates a magnitude per unit area from point 
#    features that fall within a neighborhood around each cell.
# 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
inFeatures = "rec_sites.shp"
populationField = "NONE"
cellSize = 60

# Create the Neighborhood Object
radius = 2500
myNbrCirc = NbrCircle(radius, "MAP")

# Execute PointDensity
outPdens = PointDensity(inFeatures, populationField, cellSize, 
                        myNbrCirc, "SQUARE_KILOMETERS")

# Save the output 
outPdens.save("C:/sapyexamples/output/outpdens")

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