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

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

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

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

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

Иллюстрация

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

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

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

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

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

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

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

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

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

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

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

Параметры

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

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

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

Числовое поле, определяющие значения величины (population) для каждой точки. Поле величины содержит значения количества или подсчета, которые должны быть использованы для вычисления непрерывной поверхности.

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

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

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

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

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

    • Если отсутствует поле POPULATION, но присутствует поле POPULATIONxxxx оно будет использовано по умолчанию. xxxx может быть любым действительным символом, таким как POPULATION6, POPULATION1974 и POPULATIONROADTYPE.
    • Если нет поля POPULATION или поля POPULATIONxxxx, но присутствует поле POP, по умолчанию будет использовано поле POP.
    • Если нет поля POPULATION, поля POPULATIONxxxx или поля POP, но присутствует поле POPxxxx, по умолчанию будет использовано поле POPxxxx.
    • Если нет поля POPULATION, поля POPULATIONxxxx, поля POP или поля POPxxxx, по умолчанию будет использовано поле 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

Числовое поле, определяющие значения величины (population) для каждой точки. Поле величины содержит значения количества или подсчета, которые должны быть использованы для вычисления непрерывной поверхности.

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

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

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

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

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

    • Если отсутствует поле POPULATION, но присутствует поле POPULATIONxxxx оно будет использовано по умолчанию. xxxx может быть любым действительным символом, таким как POPULATION6, POPULATION1974 и POPULATIONROADTYPE.
    • Если нет поля POPULATION или поля POPULATIONxxxx, но присутствует поле POP, по умолчанию будет использовано поле POP.
    • Если нет поля POPULATION, поля POPULATIONxxxx или поля POP, но присутствует поле POPxxxx, по умолчанию будет использовано поле POPxxxx.
    • Если нет поля POPULATION, поля POPULATIONxxxx, поля POP или поля POPxxxx, по умолчанию будет использовано поле NONE.
Field
cell_size
(Дополнительный)

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

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

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

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

Это класс Neighborhood.

Есть 4 типа классов окрестности: 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")