Плотность линий (Spatial Analyst)

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

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

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

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

Иллюстрация

OutRas = LineDensity(InRds, None, 30)

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

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

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

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

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

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

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

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

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

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

Параметры

Диалог

Подпись	Описание	Тип данных
Входные линейные объекты	Входные линейные объекты, для которых вычисляется плотность.	Feature Layer
Поле генеральной совокупности	Числовое поле, определяющие значения величины (population - количество раз подсчета линии) для каждой полилинии. Значения в поле генеральной совокупности могут быть целочисленными или с плавающей точкой. Опции и поведение по умолчанию для поля перечислены ниже. Используйте значение Нет, если не будет использовано какого-либо показателя или специального значения, и каждый объект будет подсчитан один раз. Если входные объекты содержат значения 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
Радиус поиска (Дополнительный)	Радиус поиска, в пределах которого будет вычислена плотность. Единицы измерения выбираются, основываясь на линейных единицах проекции пространственной привязки выходных данных. Например, если единицы в метрах – чтобы включить все пространственные объекты в окрестность в 1 милю – установите радиус поиска в 1609,344 (1 миля = 1609,344 метра). По умолчанию, используется значение меньшего из размеров ширины или высоты экстента выходных объектов на выходной пространственной привязке, деленное на 30.	Double
Единицы площади (Дополнительный)	Указывает единицы площади, которые будут использоваться для выходных значений плотности. По умолчанию единицы измерения определяются на основе линейных единиц выходной пространственной привязки. Можно изменить их на соответствующие единицы измерения, чтобы преобразовать выходные данные плотности. Значения для плотности линий преобразуют единицы измерения и длин, и площадей. Если выходная пространственная привязка не указана, то она будет такой же, что и у входного класса пространственных объектов. Единицы выходной плотности по умолчанию определяются по линейным единицам выходной пространственной привязки. Если выходными линейными единицами измерения являются метры, то выходными площадными единицами измерения плотности будут установлены Квадратные километры, что обеспечивает вывод квадратных километров для точечных объектов или километров на квадратный километр для полилинейных объектов. Если выходными линейными единицами измерения являются футы, то выходными площадными единицами измерения плотности будут установлены Квадратные мили. Если выходными единицами измерения являются иные, чем футы или метры, единицы, то выходными площадными единицами измерения плотности будут установлены Квадратные единицы карты. Таким образом единицы выходной плотности будут квадратом линейных единиц выходной пространственной привязки. Например, если выходными линейными единицами измерения являются сантиметры, то выходными площадными единицами измерения плотности будут Квадратные единицы карты, что приводит к результату в квадратных сантиметрах. Если выходными линейными единицами измерения являются километры, то выходными площадными единицами измерения плотности будут Квадратные единицы карты, что приводит к результату в квадратных километрах. Доступными опциями и соответствующими им выходными единицами измерения плотности являются следующие: Единицы площади карты—Будет использоваться квадрат линейных единиц измерения для выходной пространственной привязки. Квадратные мили—Будут использоваться мили США. Квадратные километры—Будут использоваться километры. Акры—Будут использоваться Акры США. Гектары—Будут использоваться гектары. Квадратные ярды—Будут использоваться ярды США. Квадратные футы—Будут использоваться футы США. Квадратные дюймы—Будут использоваться дюймы США. Квадратные метры—Будут использоваться метры. Квадратные сантиметры—Будут использоваться сантиметры. Квадратные миллиметры—Будут использоваться миллиметры.	String

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

Подпись	Описание	Тип данных
Выходной растр	Выходной растр плотности линий. Это всегда растр с плавающей точкой.	Raster

Python

LineDensity(in_polyline_features, population_field, {cell_size}, {search_radius}, {area_unit_scale_factor})

Имя	Описание	Тип данных
in_polyline_features	Входные линейные объекты, для которых вычисляется плотность.	Feature Layer
population_field	Числовое поле, определяющие значения величины (population - количество раз подсчета линии) для каждой полилинии. Значения в поле генеральной совокупности могут быть целочисленными или с плавающей точкой. Опции и поведение по умолчанию для поля перечислены ниже. Используйте значение Нет, если не будет использовано какого-либо показателя или специального значения, и каждый объект будет подсчитан один раз. Если входные объекты содержат значения 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
search_radius (Дополнительный)	Радиус поиска, в пределах которого будет вычислена плотность. Единицы измерения выбираются, основываясь на линейных единицах проекции пространственной привязки выходных данных. Например, если единицы в метрах – чтобы включить все пространственные объекты в окрестность в 1 милю – установите радиус поиска в 1609,344 (1 миля = 1609,344 метра). По умолчанию, используется значение меньшего из размеров ширины или высоты экстента выходных объектов на выходной пространственной привязке, деленное на 30.	Double
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

Пример кода

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

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

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outLDens = LineDensity("roads.shp", "LENGTH", 45, 1000, "SQUARE_MILES") 
outLDens.save("C:/sapyexamples/output/ldensout")

Скрипт LineDensity, пример 2 (автономный скрипт)

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

# Name: LineDensity_Ex_02.py
# Description: Calculates a magnitude per unit area from polyline features
#    that fall within a radius 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
inPolylineFeatures = "roads.shp"
populationField = "length"
cellSize = 120
searchRadius = 1500

# Execute LineDensity
outLineDensity = LineDensity(inPolylineFeatures, populationField, cellSize,
                             searchRadius, "SQUARE_MILES") 

# Save the output 
outLineDensity.save("C:/sapyexamples/output/linedensity")

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

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

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

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